home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / FSCREEN.HDR < prev    next >
Text File  |  1994-04-25  |  3KB  |  68 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _FScreen( cScrMsg , cKeyList , cHeader ) --> NIL
  8.  
  9. PARAMETERS:
  10.  
  11. cScrMsg  : Text for SCREEN_TITLE line MAXROWS()-2
  12. cKeyList : Text for Key List Line MAXROWS()-1
  13. cHeader  : Text for Screen Header Line 1
  14.  
  15. SHORT:
  16.  
  17. Display a standard KLIPPER screen.
  18.  
  19. DESCRIPTION:
  20.  
  21. _Fscreen() is a screen draw function that is used to refresh screens in a
  22. uniform manner.  It is designed to be used with _Menu(), and _KeyList(), and
  23. other functions which are used together to build screen i/o with a uniform
  24. appearance.
  25.  
  26. Each screen has three user definable areas.  The top screen header line and
  27. the two bottom lines.  The next to the bottom line is the screen title line
  28. and the bottom line is the _KeyList() line where key help and other user
  29. messages are expected to appear.
  30.  
  31. NOTE:
  32.  
  33. _FScreen() is fashioned after a popular menuing system.  It helps your
  34. applications fit smoothly with the Saber Menu System (TM?).  I originally
  35. wrote applications that were run under Saber Menu System on Novell.
  36.  
  37. The _FScreen() function thereby made my application almost completely
  38. transparent.  It became almost indiscernable when the user had left the menu
  39. system and had entered the application (and vice versa).
  40.  
  41. _Fscreen() was used to do the screen of the KLIPDOCS.EXE demo program.
  42.  
  43. Optionally, you may control the color of the screen drawn by declaring
  44. any/none of the following variables in your source code:
  45.  
  46. PRIVATE _FSHeadColor := 'W+/G'  // Use high white on green for cHeader Area
  47. PRIVATE _FSTitlColor := 'W+/B'  // Use high white on blue for cScrMsg Line
  48. PRIVATE _FSBottColor := 'W+/R'  // Use high white on red for cKeyList Line
  49. PRIVATE _FSDeskColor := 'w+/B'  // Use high white on blue for DeskTop Area
  50. PRIVATE _FSDeskChar  := repl('░',9) // Use ░ as the desktop bckgrnd char
  51.  
  52. Note _FSDeskChar is a character scheme that is passed to the BOX command. It
  53. must be nine characters in length or the results will be unpredictable.
  54.  
  55. Another desktop scheme might be chr(176) as a background, with a bordering
  56. box:
  57.  
  58. PRIVATE _FSDeskChar  := '┌─┐│┘─└│░'
  59.  
  60. EXAMPLE:
  61.  
  62. _FScreen('Departmental Expense Report System - Version 1.0', ;
  63.          'F1 - Help, ESC Exit, Use Arrow Keys, ENTER to Accept', ;
  64.          'The XYZ Corporation of America')
  65.  
  66.  
  67. ******************************************************************************/
  68.